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THE  MTS  DATA  COLLECTION  FACILITY 


I.  BACKGROUND 

In  order  to  understand  the  character  of  the  data 
collection  facility,  it  is  necessary  to  know  something  about 
the  structure  of  MTS,  The  MTS  system  is  built  on  top  of  a 
multiprogramming  supervisor  called  UMMPS.  UMMPS  executes  jobs , 
which  are  initiated  and  controlled  from  the  operator's  console 
typewriter.  Each  job  runs  in  problem  state  and  uses  supervisor 
calls  for  all  its  input  and  output  operations. 

The  basic  set  of  instructions  (which  is  executed  when 
an  UMMPS  job  is  initiated)  is  called  a  j ob  program.  Job  pro¬ 
grams  are  core-resident.  They  include  the  specification  of  a 
set  of  device  types  and  memory  buffers  of  various  sizes.  When 
a  job  is  activated,  actual  devices  and  memory  space  are  allo¬ 
cated  to  fit  the  specifications.  By  means  of  supervisor  calls, 
jobs  may  obtain  and  release  additional  devices  and  space  during 
execution . 

MTS  is  a  reentrant  job  program  in  UMMPS.  It  pro. ides 

the  capability  of  loading,  executing,  and  controlling  other 

programs,  and  offers  a  system  of  line  files  for  the  online 

storage  of  programs  and  data.  An  MTS  job  is  distinguished  by 

the  fact  that  it  can  use  virtual  storage:  jobs  using  any  other 

job  program  acquire  and  release  main  core  storage.  UMMPS  makes 

use  of  the  dynamic  relocation  hardware  peculiar  to  the  System/ 

360  Model  67  to  provide  each  MTS  job  with  a  virtual  memory 
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space  of  256  pages  (one  page  =  4096  bytes).  The  supervisor 
manager,  core  storage  with  a  demand  paging  algorithm,  using 
an  IBM  2301  Drum  (and  eventually  the  2314  Disk)  for  secondary 
storage.  The  paging  drum  processor  runs  as  a  separate  (non- 
MTS)  job  in  UMMPS . 

II.  STRUCTURE 

At  appropriate  points  in  UMMPS  and  the  MTS  job  pro¬ 
gram,  instructions  have  been  added  to  supply  data  about  system 
and  program  operation.  Data  are  actually  collected  by  a  super¬ 
visor  subroutine,  which  is  called  from  a  number  of  points  in 
the  supervisor  and  can  be  invoked  in  problem  state  (e.g.,  in 
the  MTS  program)  via  a  supervisor  call. 

The  UMMPS  subroutine  places  data  item  and  job  identi¬ 
fication,  the  time,  and  specific  item  data  into  buffers  allo¬ 
cated  to  a  job  called  STAT  which  must  be  active  in  order  for 
data  collection  to  take  place.  The  STAT  job  links  and  man¬ 
ages  the  emptying  of  its  buffers  onto  magnetic  tape,  controls 
the  type  and  origin  of  the  data  to  be  collected,  and  places  ad¬ 
ditional  data  items  in  the  buffer  specifying  the  jobs  from 
which  the  data  were  taken. 

Tapes  of  MTS  data  are  processed  by  a  program  in  the 
MTS  file  ^ANALYSIS,  which  is  essentially  a  general-purpose 
filter  for  selecting  items  from  the  tape,  together  with  a  data- 
reduction  analysis  to  decode  overall  states  of  a  program  (e.g., 
execution,  I/O  wait)  from  the  standard  supervisor  data  items. 
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III.  CAPABILITIES 


Some  two  dozen  kinds  of  system  data  items  can  now  be 
routinely  collected  by  invoking  this  facility.  In  addition, 
an  assembly- language  programmer  can  supply  his  own  data  by 
executing  the  appropriate  SVC  instruction.  Transitions  to  and 
from  the  CPU  wait  state  can  be  recorded. 

Each  item  of  data  contains  a  five-byte  clock  value, 
which  is  the  number  of  (high- res olution)  timer  units  since  mid¬ 
night.  A  timer  unit  is  13  1/48  microseconds.  By  performing 
repeated  experiments  and  making  appropriate  allowances  for  the 
overhead  introduced  by  the  data  collection  facility  itself,  it 
is  in  some  cases  possible  to  clock  events  of  a  durrtion  shorter 
than  a  single  timer  unit. 

IV.  PROCEDURES  FOR  TAKING  DATA 

Data  collection  is  initiated  by  mounting  one  or  two 
(7  or  9)  track  tapes  and  starting  the  STAT  job  at  the  operator's 
console.  If  only  one  tape  is  specified  the  job  is  automatical¬ 
ly  terminated  when  it  is  full.  Reel  switching  occurs  back  aud 
forth  between  a  pair  of  tapes. 

A  second  UMMPS  job  called  STATSW  is  invoked  once  STAT 
is  running  when  one  wishes  to  alter  the  designation  of  jobs  or 
items  for  data  collection.  Except  for  the  absence  of  tape  de¬ 
vice  names,  the  parameters  for  STATSW  are  exactly  those  of 
STAT. 
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The  first  STAT  parameter  must  be  a  tape  name.  If 
two  tapes  are  used,  thi  second  parameter  must  specify  the 
second  tape  name.  The  remaining  parameters  give 


a.  job  numbers  of  jobs  for  which  data  are  to  be 

collected, 

b.  item  numbers  of  data  items  which  are  to  >e  col 
lected  for  the  specified  jobs, 

c.  global  parameters  to  specify  groups  of  jobs  or 

items , 


d.  and  parameters  which  precede  the  lists  of  job/ 
item  numbers  and  indicate  the  way  in  which  they  should  be 
used . 


A  job  number  is  a  unique  positive  integer  assigned 
by  UMMPS  whenever  a  job  is  initiated  at  the  operators  console 
typewriter.  Each  line  on  the  console  sheet  is  prefaced  by 
the  job  number  to  which  the  line  applies.  The  TASKS  job  lists 
all  active  jobs  and  their  corresponding  job  numbers.  The  job 
number  of  an  MTS  job  is  also  printed  in  the  greeting  line  at 
a  remote  terminal. 

An  item  number  is  an  integer  between  0  and  31.  Items 
of  type  0  and  1  are  always  collected.  The  definitions  of  the 
remaining  item  types  (except  for  the  unused  types)  are  given 
in  Appendix  A. 

The  global  parameters  used  to  specify  groups  of  job 
and  item  numbers  are  ALL,  NONE,  and  MTS.  The  MTS  parameter 
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applies  only  to  job  numbers,  and  means  all  UMMPS  jobs  that 
use  the  MTS  job  program. 

The  following  parameters  precede  lists  of  numbers 
and  global  parameters:  JOBS,  meaning  that  a  subsequent  para¬ 
meter  is  a  job  number  or  job  global  parameter;  ITMS,  meaning 
that  a  subsequent  parameter  is  an  item  number  of  item  global 
parameter;  -t  JOB,  meaning  that  data  collection  is  to  be 
turned  off  for  the  immediate  following  list  of  job  numbers; 

-j  ITM,  meaning  that  the  specified  data  items  are  not  hence¬ 
forth  to  be  collected  for  whatever  jobs  are  later  designated. 

The  default  assignment  of  parameters  is 

JOBS  NONE  ITMS  ALL  , 

hence  no  data  collection  will  take  place  unless  at  least,  one 
job  number  is  designated,  but  all  items  will  be  collected  for 
whatever  jobs  are  given. 

In  MTS  the  CPU  time  in  wait  state  and  interrupt  pro¬ 
cessing  unassigned  to  jobs  is  charged  to  a  dummy  job  whose  job 
number  is  zero.  If  job  0  is  specified  for  data  colle'-tior. 
then  all  transitions  to  and  from  wait  state  can  be  recorded. 


V.  TAKING  SPECIAL  DATA 


By  means  of  the  supervisor  call 

SVC  STATENT 
STATENT  EQU  44 

an  assembly-language  program  can  cause  a  special  data  item  to 
be  inserted  in  the  STAT  buffers.  This  SVC  assumes  that  general 
registers  zero  and  one  contain  the  appropriate  identification 
and  data  address : 

GRO:  The  ID  and  length  (in  words)  of  the  entire 

data  item,  in  the  form 

ID*8+LENGTH- 1  . 

The  length  includes  the  two  words  added  to 
the  front  of  special  data  by  the  supervisor, 
and  the  entire  item  may  be  no  more  than  eight 
words  long. 

GR1:  The  address  of  the  third  and  succeeding  words, 

if  any,  of  the  data  item. 

The  SVC  writes  a  data  item  only  if  the  issuing  job 

has  data  collection  for  the  given  ID  (item  number)  designated. 

One  item  type  '#23)  is  specifically  reserved  for  the  use  of 

system  programmers  for  the  collection  of  special  data,  and  in 

general  it  should  be  used,  since  any  other  type  may  be  assigned 
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tc  a  standard  system  function.  As  an  example,  then,  if  one 
wanted  to  collect  the  two  words  of  data  at  the  location  MARK 
in  his  program,  the  required  code  is 

1A  0,  23*8+4-1 

LA  1,  MARK 

SVC  STATENT 

since  the  total  item  length  will  be  four  words. 

VI.  DATA  ANALYSIS 

The  MTS  file  *ANALYSIS  contains  the  object  module 
of  a  general-purpose  data  reduction  program,  which  can  be  used 
to 

(1)  Print  the  annotated  and  interpreted  data  items 
just  as  they  were  placed  on  the  tape. 

(2)  Reduce  the  standard  system  data  items  to  a 
sequence  of  ready,  active  and  wait  intervals  for  each  job,  to¬ 
gether  with  relevant  additional  information  abstracted  from 
the  data. 

(4)  Call  a  subroutine  at  the  point  where  each  ready, 
etc.  interval  would  be  printed  out,  with  a  pointer  to  the 
entire  job  description  at  that  instant. 

(8)  Wr:'te  the  output  on  tape. 

(16)  Call  a  subroutine  for  each  item  having  to  do 


with  paging  da'.a. 


rt-m'iii  nil'll 
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(32)  Print  a  data- reduced  description  of  each  paging 

item. 

(64)  Call  a  subroutine  for  each  item  as  it  is  re¬ 
ceived  from  the  data  tape. 

(128)  Print  a  one-line  description  of  each  record  on 
the  data  tape. 


These  output  options  and  a  number  of  other  actions 
are  invoked  by  specifying  a  combination  of  the  following  key¬ 
word  parameters  following  "PAR*"  in  the  $RUN  command  for 
* ANALYSIS .  The  parameters  must  contain  no  blanks,  and  integers 
are  not  checked  for  validity: 

0?TN  =  integer 

The  integer  (between  0  anu  255T  specifies  the  desired 
output  options  from  the  above  list.  It  is  the  sum  of  the  op¬ 
tion  numbers  (in  parenthese  above)  of  the  desired  types  of 
output.  The  i  fault  case  is 

OPTN  *  161 

or,  in  other  words,  all  options  (1,  2,  32,  128)  v?hich  p  ovide 
printed  output,  but  no  others. 

SFIL  =  integer 

This  integer  specifies  the  number  of  files  to  be 
skipped  on  the  input  tape.  Default  = 


0. 
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CFIL  =  integer 

The  number  of  files  of  data  to  be  converted  from  the 
tape.  Default  =  1  . 

SREC  -  integer 

The  number  of  records  (one  record  *  about  350  items)  to 
be  skipped  on  the  tape.  The  default  is  zero. 

CREC  -  integer 

The  number  of  records  to  be  converted  from  the  tape. 
Deluult  *  one  entire  file. 

SITM  -  integer 

The  number  of  items  to  be  skipped  on  the  tape. 

Default  =  0. 


CITM  -  integer 

The  number  of  items  to  be  converted  from  the  tape. 
Default  =  one  entire  file. 


ITMS  =  A  list  of  item  numbers  separated  by  commas 

This  list  specifies  the  item  types  which  are  to  be 
converted  from  the  data  tape.  All  others  are  skipped  entirely. 
The  default  case  is  to  convert  all  items. 

-il  TM  =  list 


This 

list 

specific 

s  the 

item  types 

which  are 

not  to 

be 

converted  from  the  data 

tape . 

When  this 

parameter 

is  used 

all 

other  types 

are 

convert 

ed . 

r 
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JOBS  =  list 

A  list  of  job  numbers  of  UMMPS  jobs  whose  items  are 
to  be  converted.  Items  for  other  jobs  are  skipped  entirely. 

The  default  case  is  no  jobs,  except  that  the  occurrence  of  a 
STATSW  item  (#7)  in  the  data  automatically  begins  conversion 
for  the  job  for  which  it  was  collected.  STATSW  items  are  placed 
in  the  data  by  the  STAT  and  STATSW  jobs  whenever  recording  is 
designated  for  a  job.  The  word  ALL  may  be  written  instead  of 
a  job  number  list. 

MFMT  «  format 

The  MFMT  parameter,  if  used,  must  be  the  last  to  ap¬ 
pear  in  the  parameter  list,  and  its  value  can  be  up  to  100 
characters  long.  This  parameter  supplies  a  format  for  printing 
MARK  items  (#23).  The  standard  format  of  item  code,  job 
number,  interval  time,  etc.  appears  at  the  head  of  the  line, 
and  the  given  format  is  used  to  control  the  printing  of  the 
(up  to  6)  words  of  variable  information  which  may  be  included 
in  a  data  item.  Eighty-eight  columns  are  available  for  the 
output  image.  The  print  format  call  on  I0H/360  specifies 
those  six  words  as  a  block,  preceded  by  the  (halfword)  length 
of  the  data  (in  words)  in  this  particular  occurrence  of  the 
item.  The  default  parameter  specification  is 

I4H.C24 , S- 28* 


but  the  count  can  be  used  with  a  list-type  format  variable  to 
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print  only  the  existing  data,  e.g., 

V (X8 . S2) , 8  (BXO) * 

prints  the  data  in  hexadecimal  words  separated  by  pairs  of 
blanks  . 

PARM  =  anything 

The  address  of  this  parameter  is  passed  to  the  ini¬ 
tialization  entry  of  subroutines  called  by  the  * ANALYSIS  pro¬ 
gram.  It  is  terminated  b/  the  first  blank  to  appear  after  the 
keyword  and  equal  sign.  Like  the  MFMT  parameter,  this  para¬ 
meter,  if  used,  must  be  the  last  to  appear  in  the  parameter 
list . 

General  Notes: 

a.  SREC  and  SFiL  are  processed  as  soon  as  they  are 
decoded  in  the  parameter  list.  Hence  they  should  be  placed  in 
the  intended  order  when  they  are  both  specified. 

b.  The  STATSW  items  which  cause  ‘ANALYSIS  to  begin 
converting  items  for  a  particular  job  typically  occur  at  the 
very  beginning  of  the  data.  If,  however,  these  items  are 
eliminated  via  ITMS  of  V7M,  then  the  JOBS  parameter  must  be 
used  to  indicate  which  jobs  are  to  have  their  data  converted. 

c.  The  SITM  t.td  CITM  counts  apply  only  to  the  types 
of  items  being  converted. 

d.  The  ‘MOUNT  program  must  be  run  for  the  STAT  data 
tape,  since  the  records  range  up  to  4084  bytes  in  length. 


. . siwwfippf. 
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e.  Four  unlabeled  numbers  appear  on  the  leader  lin^ 
of  each  page  of  ‘ANALYSIS  output:  they  are  the  current  input 
tape  record,  selected  item  count,total  item  count,  and  time  for 
first  item  on  the  page,  respectively.  The  record  and  selected 
item  counts  do  not  include  skipped  data,  but  the  total  item 
count  includes  those  skipped  with  the  SITM  parameter. 

Appendix  B  shows  an  example  of  the  MTS  commands  neces¬ 
sary  to  use  the  * ANALYSIS  program. 


VII.  ANALYSIS  SUBROUTINES 

Options  (.4),  (16),  and  (64)  for  the  analysis  program 
provide  for  calling  subroutines  and  supplying  them  with  ap¬ 
propriate  data.  The  names  and  functions  of  the  expected  routines 
are  given  below.  If  any  subroutine  option  is  specified,  one 
supplies  his  own  object  modules  concatenated  with  ‘ANALYSIS 
(1,500):  the  latter  file  has  existing  definitions  for  the  sub¬ 
routine  names  beginning  at  line  501. 


OPTN 

ROUTINE 

PARAMETERS 

Initialization 

STP2A 

PARM 

4 

STP2B 

JOBAREA,  ITEMAREA 

16 

STP2C 

JOBAREA, 

ITEMAREA,  PAGEAREA 

64 

STP2E 

JOBAREA, 

ITEMAREA 

Termination 

STP2C 

The  initialization  and  termination  entry  points  are 
called  by  ‘ANALYSIS  if  at  least  one  of  the  subroutine  options 


It: 


if 


mm 


if 


I 
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is  given.  The  ITEMAREA  contains  the  input  item  exactly  as  taken 
from  the  data  tape.  The  formats  for  JOBAREA  and  PAGEAREA  are 
given  in  Appendix  C. 


VIII.  EXAMPLES 

Appendix  D  shows  examples  of  the  various  kinds  of 
output  obtained  from  the  ‘ANALYSIS  program  and  some  of  the 
subroutines  written  to  be  called  by  it.  Each  sample  is  pre¬ 
faced  by  a  short  description. 


MHRi 


APPENDIX  A 


NAME 

OVERFLOW* 

DATE* 

ADTOTP 

POPQ 


STANDARD  DATA  ITEMS  COLLECTED  WITH  STAT... 


PARTS  OF  THE  DATA  ITEMS  WHICH  ARE  NOT  DES¬ 
CRIBED  BELOW  ARE  NOT  USED  OR  CONTAIN  MEANING¬ 
LESS  DATA. 

LACH  STANDARD  ITEM  BEGINS  WITH  A  TWO-WORD 
PREFIX:  THE  ID  AND  LENGTH  IN  BYTE  1  IN  THE 
FORM  ID  *8  +  LEN- 1 ,  THEN  THE  LOW-ORDER  TIMER 
BYTE  IN  BYTE  2.  THE  JOB  NUMBER  OCCUPIES 
BYTES  3-4,  AND  THE  TIMER  WORD  IS  IN  BYTES 
5-8. 


NOTE:  THE  FIRST  TWO  ITEMS  ARE  PLACED  IN  THE 
BUFFERS  BY  STAT  ITSELF  AND  DO  NOT  HAVE 
THE  STANDARD  PREFIX  DESCRIBED  ABOVE. 


ID/LEN  DESCRIPTION 

0/1  THE  SECOND  HALF-WORD  OF  THIS  ONE-WORD  ITEM 

CONTAINS  A  COUNT  OF  THE  NUMBER  OF  ITEMS  WHICH 
WERE  MISSED  AT  THE  POINT  OF  OCCURRENCE  BE¬ 
CAUSE  THE  STAT  JOB  COULD  NOT  KEEP  UP. 

1/3  WORDS  TWO  AND  THREE  OF  THIS  ITEM  CONTAIN  THE 
EBCD  DATA  OBTAINED  FROM  THE  SYSTEM  AND  PLACED 
IN  THE  FIRST  BUFFER  BY  THE  STAT  JOB. 

2/3  THIS  ENTRY  OCCURS  WHEN  A  NEW  ENTRY  IS  ADDED 
TO  THE  TOP  OF  THE  CPU  QUEUE  FOR  THIS  JOB. 

BYTE  9  CONTAINS  THE  INDEX  OF  THE  NEW  CPU  Q 
ENTRY,  AND  BYTES  10-12  CONTAIN  ITS  ADDRESS. 

3/3  THIS  ENTRY  OCCURS  WHENEVER  AN  ENTRY  IS  RE¬ 
MOVED  FROM  THE  TOP  OF  THE  CPU  QUEUE  FOR  THIS 
JOB.  BYTE  9  HAS  THE  INDEX  AND  BYTES  10-12 
THE  ADDRESS  OF  THE  NEW  TOP  OF  Q  ENTRY,  AS 
ABOVE. 


A-  1 


A-  2 


NAME  id/len  description 

WAYT  4/4  A  WAYT  ENTRY  OCCURS  WHEN  A  JOB  ENTERS  WAIT 

STATE  AT  ITS  TOP  CPU  Q  LEVEL  FOR  ANY  REASON. 
BYTE  9  CONTAINS  THE  INDEX  OF  THE  NEXT  LOWER 
WAYT  Q  ENTRY,  AND  BYTE  10  THE  INDEX  OF  TIE 
CPU  Q  ENTRY  CORRESPONDING  TO  THE  NEW  WAYT. 

BYTES  11-12  CONTAIN  THE  HEX  VALUE  OOFF  IF 
THE  WAIT  WAS  NOT  FOR  I/O,  OTHERWISE  THEY  CON¬ 
TAIN  THE  DEVICE  ADDRESS.  BYTES  13-16  CON¬ 
TAIN  THE  FLAG  AND  ADDRESS  SPECIFYING  THE  LOCA¬ 
TION  OF  A  WAIT  BYTE. 

UNWAYT  5/3  WHENEVER  A  JOB  STOPS  WAITING  FOR  ANY  EVENT  AT 

ANY  CPU  QUEUE  ENTRY,  THE  INDEX  OF  THE  TOP 
REMAINING  WAYT  Q  ENTRY  IS  GIVEN  IN  BYTE  9, 

AND  THE  ADDRESS  IN  BYTES  10-12. 

Q  6/3  THIS  TYPE  OF  ITEM  IS  RECORDED  WHENEVER  THE 

JOB  GIVEN  BY  THE  NUMBER  IN  BYTES  3-4  RELIN¬ 
QUISHES  THE  CPU  TO  THE  JOB  WHOSE  NUMBER  IS  IN 
BYTES  11-12. 

STATSW  7/4  THE  JOB  NUMBER  GIVEN  IN  BYTES  11-12  IS  THAT 

OF  A  JOB  WHOSE  STATUS  WITH  RESPECT  TO  DATA 
RECORDING  HAS  JUST  CHANGED.  RECORDING  HAS 
JUST  BEGUN  IF  BYTE  9  IS  ZERO  AND  HAS  JUST 
ENDED  IF  BYTE  9  IS  FF.  BYTES  13-16  CONTAIN 
THE  RECORDING  BITS  USED  IN  THE  JOB  TABLE 
FROM  THIS  POINT  ON  DURING  COLLECTION. 

PAGINSTR  8/5  WHEN  A  PAGE-IN  OPERATION  IS  STARTED  THE  FOLLOW¬ 

ING  IS  GIVEN:  THE  REAL  CORE  PAGE  ADDRESS  IN 
BYTES  8-9,  THE  VIRTUAL  MEMORY  PAGE  ADDRESS  IN 
BYTES  10-11,  THE  PAGE  CONTROL  BLOCK  STATUS 
BITS  IN  BYTE  12,  THE  NUMBER  OF  PAGE-WAITS 
FOR  THE  JOB  IN  BYTE  13,  THE  NUMBER  OF  REAL 
PAGES  FOR  THE  JOB  IS  BYTE  14,  THE  STORAGE” 

KEY  AND  OTHER  BITS  IN  BYTE  16,  THE  PDP  AND 
ADDRESS  FLAGS  IN  BYTE  17,  AND  THE  EXTERNAL 
(TRACK,  SLOT)  ADDRESS  IN  BYTES  18-19.  SEE 
THE  FILE  *PCBDSECT  FOR  MORE  INFORMATION  ABOUT 
THESE  BITS  OF  INFORMATION. 

PAGINDON  9/5  WHEN  A  PAGE-IN  OPERATION  IS  COMPLETED  THE 

SAME  DATA  DATA  IS  GIVEN  AS  FOR  'PAGINSTR' 

ABOVE. 

P AGOUTST  10/5  WHEN  A  PAGE-OUT  OPERATION  IS  INITIATED  THE 

SAME  DATA  IS  GIVEN  AS  FOR  'PAGINSTR'  ABOVE. 


NAME 

PAGOUTDN 

PAGRECLM 

GETVMPAG 

FREVMPAG 

MARK 

VMPAGES 

WAITFOR 

UNLOAD 

LOAD 

FREESPAC 
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ID/LEN  DESCRIPTION 

11/5  WHEN  A  PAGE-OUT  OPERATION  IS  COMPLETED  THE 
SAME  DATA  IS  GIVEN  AS  FOR  ' PAGINSTR '  ABOVE. 

12/5  IF  A  PAGE  IS  RECLAIMED  DURING  PAGE-OUT  THE 
VERY  SAME  DATA  IS  GIVEN  Aw  FOR  'PAGINSTR' 
ABOVE. 

13/5  WHEN  A  NEW  VIRTUAL  MEMORY  PAGE  IS  ALLOCATED 
THE  SAME  DATA  IS  GIVEN  AS  FOR  'PAGINSTR' 

ABOV  E. 

14/5  WHEN  A.  VIRTUAL  MEMORY  PAGE  IS  RELEASED  THE 
VERY  SAME  DATA  IS  GIVEN  AS  FOR  'PAGINSTR' 
ABOVE. 

23/?  THIS  ENTRY  IS  RESERVED  FOR  THE  USE  Or  SYSTEM 
PROGRAMMERS  IN  THAT  IT  IS  THE  ONLY  ONE  GUAR¬ 
ANTEED  TO  BE  UNASSIGNED  TO  SOME  STANDARD 
SYSTEM  FUNCTION,  AND  IS  'WATCHED  FOR'  BY 
THE  ‘ANALYSIS  PROGRAM  SO  THAT  IT  APPEARS 
WITH  INTERVAL  TIMING  ON  THE  OUTPUT  FORMAT, 

AND  IS  APPROPRIATELY  MARKED  ON  INPUT  FORMAT. 

24/5  WHENEVER  THE  NUMBER  OF  HALF-PAGES  USED  BY 
SOMEONE  EITHER  INCREASES  OR  DECREASES,  AN 
ENTRY  APPEARS  TO  GIVE  THE  CURRENT  VALUE  OF 
THE  SPACE-TIME  INTEGRAL  IN  300THS  OF  A 
SECOND  TIMES  HALF-PAGES  IN  BYTES  9-12  AND 
THE  TIME  OF  DAY  WHEN  THE  VALUE  LAST  CHANGED 
IN  BYTES  13-16,  WITH  THE  CURRENT  (NEW)  NUMBER 
OF  HALF  PAGES  IN  BYTES  17-20.  NOTE  THAT  THIS 
IS  A  VIRTUAL,  NOT  REAL,  STORAGE  USE  INTEGRAL 

25/2  A  MINIMAL  ENTRY  IS  MADE  WHENEVER  AN  MTS  USER 
SIGNS  OFF,  LEAVING  THE  JOB  FOR  SOMEONE  ELSE. 

26/7  WHEN  THIS  TYPE  OF  ITEM  APPEARS  A  PROGRAM  HAS 
JUST  BEEN  UNLOADED  IN  MTS.  ITS  NAME  IS  GIVEN 
IN  BYTES  9-24  AND  THE  STORAGE  INDEX  N'JMBER 
CORRESPONDING  IS  IN  BYTE  25. 

27/7  THE  INFORMATION  PROVIDED  ABOVE  FOR  AN  UN¬ 
LOAD  IS  ALSO  GIVEN  FOR  EVERY  LOAD. 

28/3  WHEN  CORE  SPACE  IS  RELEASED  BY  AN  MTS  JOB  THE 
STORAGE  INDEX  NUMBER  IS  GIVEN  IN  BYTE  9  AND 
THE  NUMBER  OF  BYTES  RELEASED  IS  GIVEN  IN 
BYTES  10-12. 


NAME 


ID/LEN 


DESCRIPTION 


GETSPACE 

DSRIN 


DSROUT 

DSROUT 


A- 4 


29/3  THE  SAME  INFORMATION  IS  GIVEN  WHENEVER  CORE 
SPACE  IS  REQUESTED  BY  AN  MTS  JOB. 

30/2  WHEN  A  DEVICE  SUPPORT  ROUTINE  IS  ENTERED  THE 
MINIMUM  TWO-WORD  ITEM  IS  GIVEN  FOR  AN  INPUT 
LINE,  AND  FOR  AN  OUTPUT  LINE  THE  FOLLOWING: 
BYTES  9-12  CONTAIN  THE  FILE  OR  DEVICE  NAME. 
BYTE  13  CONTAINS  THE  CURRENT  PREFIX  CHARACTER. 
THE  FIRST  BYTE  OF  THE  FDUB  (INCLUDING  A  BIT 
FOR  INPUT  OR  OUTPUT)  IS  GIVEN  IN  BYTE  14. 

BYTES  15-16  CONTAIN  THE  LENGTH  OF  THE  I/O 
MESSAGE,  AND  BYTES  17-20  CONTAIN  THE  FIRST 
FOUR  CHARACTERS.  THIS  INFORMATION  IS  CUR¬ 
RENTLY  COLLECTED  ONLY  FOR  I/O  FOR  DEVICES 
(NOT  FILES),  AND  NOT  FOR  LINES  WITH  A  PREFIX 
CHARACTER  OF  .  (INDICATING  LOADING). 

31/5  WHEN  A  DEVICE  SUPPORT  ROUTINE  IS  EXITED,  THE 
MINIMUM  ENTRY  IS  GIVEN  FOR  AN  OUTPUT  LINE, 

AND  THE  ITEM  WHICH  IS  DESCRIBED  ABOVE  FOR 
OUTPUT  LINES  AT  DSRIN  IS  GIVEN  AT  DSROUT 
FOR  INPUT  LINES. 

31/7  IF  AN  INPUT  LINE  BEGINS  WITH  THE  CHARACTERS 

$SIG  THEN  TWO  ADDITIONAL  WORDS  (8  CHARACTERS) 
OF  THE  LINE  ARE  GIVEN  IN  BYTES  21-28. 


APPENDIX  B 

$RUN  *MOUNT  PAR  =  S  390  9TP ,  * STAT* ,  SI2E  =  4096,  'MASTER  DATA  TAPE’,- 
RING  OUT. 

$RUN  ‘ANALYSIS  SCARDS=*STAT*  SPRINT= *SINK*@MCC  PAR=OPTN=l,- 
SFIL=2.SREC=15,CITM=520>ITMS=0,23,JOBS=ALL 

(The  above  run  converts  only  overflow  and  mark  items  from  all 
the  jobs  referenced  in  the  first  520  items  beginning  with  the 
16th  record  of  the  third  file  cn  the  tape  S390.  The  formatted 
original  data  items  only  are  printed.) 
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APPENDIX  C 


JOBINFO 

DSECT 

INFORMATION  FOR  ONE  JOB 

STATE 

DS 

C 

CURRENT  STATE  OF  JOB 

TIMEBYTE 

DS 

C 

TIMER  BYTE  FOR  CURRENT  EVENT 

DEVICE 

DS 

H 

DEVICE  NUMBER  OF  UNIT  CAUSING  LAST  WAIT 

TIMEWOP" 

DS 

F 

TIMER  WORD  FOR  CURRENT  EVENT 

JOBSEQID 

DS 

H 

SEQUENCE  NUMBER  FOR  JOB 

ITEMID 

DS 

H 

SEQUENCE  NUMBER  FOR  ITEM 

OLDSTATE 

DS 

C 

LAST  STATE  JOB  WAS  IN 

OLDTBYTE 

DS 

C 

NEXT  TO  LAST  TIMER  BYTE 

JOBNO 

DS 

H 

JOB  NUMBER  FOR  JOB 

OLDTINER 

DS 

F 

NEXT  TO  LAST  TIMER  WORD 

FDNAMb 

DS 

F 

NAME  OF  nEVICE  BEING  WAITED  FOR 

PREFIX 

DS 

C 

PREFIX  CHARACTER 

IOBYTE 

DS 

C 

INPUT  OR  OUTPUT  BYTE 

IOLENGTH 

DS 

H 

LENGTH  OF  LINE  RELAYED 

IOLINE 

DS 

3F 

FIRST  CHARACTERS  OF  LINE 

GTSW 

DS 

H 

SWITCH  FOR  GETSPACE  ITEM 

FRSN 

DS 

H 

SWITCH  FOR  FREESPACE  ITEM 

LDSW 

DS 

H 

SWITCH  FOR  LOAD  ITEM 

UNSN 

DS 

H 

SWITCH  FOR  UNLOAD  ITEM 

GETSP 

DS 

F 

SPACE  GOT  IN  ONE  INTERVAL 

.  RESP 

DS 

F 

SPACE  I'NGOT  IN  ONE  INTERVAL 

SPTMINT 

DS 

F 

SPACE-TIME  INTEGRAL  FOR  VIRTUAL  MEMORY 

HPTOD 

DS 

F 

LAST  TOD  WHEN  THE  HALF  PAGE  COUNT  CHANGED 

HPAGES 

DS 

F 

CURRENT  NUMBER  OF  VIRTUAL  MEMORY  PAGES 

PAGEIN 

DS 

C 

COUNT  OF  NUMB  R  OF  PAGE-N  OPERATIONS 

GOING 

MARKBYTE 

DS 

C 

TIMER  BYTE  FOR  MARK  ITEM 

LASTTYPE 

DS 

C 

TYPE  OF  LAST  PAGING  ENTRY 

REALPAGE 

DS 

C 

NUMBER  OF  REAL  CORE  PAGES  BEING  USED  NOW 

MARKWORD 

DS 

F 

TIMER  WORD  FOR  MARK  ITEM 

LDNME 

DS 

4F 

NAME  OF  PROGRAM  LOADED 

UNNME 

DS 

4F 

NAME  OF  PGM  UNLOADED 

WAYTQADD 

DS 

F 

ADDRESS  OF  NEXT  WAYTQ  ENTRY 

WAYTQ 

DS 

I2F 

WAYT  Q 

INUSE 

DS 

C 

USAGE  FLAG  FOR  THIS  JOB  AREA 

CPUQINDX 

DS 

C 

INDEX  OF  CURRENT  CPU  Q  ENTRY 

VALID 

DS 

C 

VALID  STATE  KNOWLEDGE  SWITCH 

DSRSW 

DS 

C 

DEVICE  SUPPORT  ROUTINE  SWITCH 

JOBEND 

* 

EQU 

* 

END  OF  A  JOB  INFO  AREA 

*  PAGE 

* 

AREA 

PAGETABL 

DSECT 

TLE 

DS 

C 

TYPE  OF  LAST  ENTRY 

TB 

DS 

c 

TIMER  BYTE 

JBNO 

DS 

H 

JOB  NUMBER 

TW 

DS 

F 

TIMER  WORD 

RCA 

DS 

H 

REAL  CORE  ADDRESS 

VMA 

DS 

H 

VIRTUAL  MEMORY  ADDRESS 

PIC 

DS 

H 

PAGE-IN  COMPLETED  COUNT 

RCC 

DS 

H 

PAGE  REALLY  RECLAIMED  COUNT 

CMSEC 

DS 

F 

TIME  IN  CORE 

DMSEC 

DS 

F 

TIME  ON  THE  DRUM 
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NAME 
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15l  HEXADECIMAL 

QUEUE 
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14 

118248033 

32699006 

01083AO2 

01C80003 

*00 TO TOP 
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Figure  1.  A  sample  of  the  data  items  on  the  tape  written  by 
STAT,  and  annotated  by  the  analysis  program.  The 
"Microsec"  column  is  simply  the  decimal  value  of 
tie  low-order  three  bytes  of  the  timer,  converted 
to  microseconds. 
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Figure  2.  A  sample  of  the  normal  printed  output  of  the  analysis 
program,  showing  the  intervals  of  execution  (ACTIVE), 
queueing  for  CPU  (READY),  and  I/O  and  page  waits. 
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Figure  3.  The  normal  paging  data  displayed  by  the  analysis 
program.  Included  are  the  current  paging  action^ 
the  last  previous  action  for  that  page,  the  per¬ 
centage  of  time  the  page  has  been  core-residant , 
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Figure  4.  The  tape  inventory  lines  produced  by  the  analysis 
program.  The  given  time  is  that  of  the  first  data 
item  in  the  record  described. 
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Figure  5.  The  item  summary  sheet  printed  by  the  analysis 

program,  showing  the  number  of  each  type  of  data 
item  encountered  and  selected  for  processing. 
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Figure  6.  A  table  of  "devices"  produced  by  a  subroutine 

receiving  output  from  the  analysis  program.  Given 
are  the  number  of  I/O  waits  for  each  "device."  The 
name  of  a  "device"  is 

a.  a  halfword  device  number, 

b.  a  device  name  (e.g.,  PTR3) , 

c.  an  address  in  the  supervisor  or  device  support 
routines  where  an  I/O  queue  is  processed. 
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Figure  7.  A  sample  page  of  output  from  a  subroutine  written 

to  assist  in  determining  equable  billing  algorithms. 


******  TMF  RECORDING  DATE  WAS  0W2-68  AND  T HE  IIMfc  WAS  13131.13 
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Figure  8.  The  output  of  a  subroutine  to  compute  CPU  utili¬ 
zation  . 
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selected  so  that  no  security  classification  is  required  Identi¬ 
fiers,  such  as  equipment  model  designation,  trade  name,  military 
project  code  name,  geographic  location,  may  be  used  as  key 
words  but  will  be  followed  by  an  indication  of  technical  con¬ 
text.  The  assignment  of  links,  rules,  and  weights  is  options! 
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